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INTRODUCTION 

This document is intended to serve as a quick reference 
and convenient memory aid for the user with some familiarity 
with Multics command conventions. 

This guide presents an abbreviated description of the 
Multics commands and active functions described in detail in 
the Multics Programmers' Manual Commands and Active 
Functions (MPM Commands), Order No. AG92. The com- 
mands are presented in alphabetical order, with each descrip- 
tion showing the proper usage and a list of the control 
arguments and optional arguments that may be used. Control 
arguments are only listed; they are not defined in detail in 
this document. 

The reader is expected to be familiar with the Multics 
command environment conventions. The following terms are 
defined here and are not explained at each occurrence in this 
document. If the reader needs more information on termi- 
nology than is given here, he should refer to "Glossary of 
Multics Terms" in Section I of the Multics Programmer's 
Manual Reference Guide, Order No. AG91. 

ACL access control list; it describes who may access 

an entry in the Multics storage system and in 
what way (see modes below). 

modes access identifiers; used to define the kind of 

access a user has to a storage system entry. The 
modes are: 

segments directories 

r (read) s (status) 

e (execute) m (modify) 

w (write) a (append) 

Null access can also be specified for either seg- 
ments or directories: " ", n, or null. 

path pathname of an entry; it can be relative or 

absolute. 

Person_id user's registered personal identifier; usually 
some form of the user's surname; unique at 
site. 
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Projected user's registered project identifier; a project is 
an arbitrary set of users grouped together for 
accounting and access control purposes. 

User_id access control name of the form Person_id. 

Project_id.tag; since the tag portion is rarely 
explicitly given, the term User_id is often de- 
fined as a Person_id.Project_id pair. 



COMMANDS 



The format of each command description in this docu- 
ment is based on those found in the MPM Commands. The 
command name, in boldface type, is shown first, followed by 
the usage line. In the usage line, the following conventions 
apply: 

1. If a command accepts more than one of a specific 
argument, an "s" is added to the argument name 
(e.g., paths, control_args). 

2. To indicate one of a group of similar arguments, an 
"i" is added to the argument name (e.g., pathi, 
control_argi). 

3. Multiple arguments that must be given in pairs are 
indicated by xxxl yyyl . . . xxxnyyyn. 

4. Pathnames that must be given in pairs are indicated by 
pathlj, path21 . . . pathlnpath2n. 

5. Optional arguments are enclosed in braces (e.g., 
{path}, {-control_args}). All other arguments are 
required. 

To illustrate these conventions, consider the following 
usage line: 

command {paths} {-control_args} 

The lines below are just a few examples of valid invocations 
of this command: 

command 

command path 

command path path -control_arg 

command path -control_arg -control_arg 

command -control_arg 

command -control_arg -control_arg 

For simplicity, when an argument takes a value other 
than a pathname (indicated by "path"), the value is indicated 
as follows: 

XX character string 

N number, decimal or octal 

DT date-time character string in a form acceptable 

to the convert_date_to_binary_ subroutine 
described in the Multics Programmers' Manual 
Subroutines, Order No. AG93. 



If more information is needed about a particular value, 
the reader should consult the appropriate command descrip- 
tion in the MPM Commands. 

The commands listed below are grouped according to 
their function. An abbreviated description for each com- 
mand is given in the following pages, arranged in alphabetical 
rather than function order. 



Access to the System 


Directory Manipulation 


(preaccess requests) 


add_name 


MAP 


create_dir 


963 


delete_dir 


029 


dele te_ name 


dial 


fs_chname 


enter 


link 


enterp 


list 


login 


rename 


logout 


safety_sw_off 




safety_sw_on 


Creating and Editing Segments 


status 


adjust_bit_count 


unlink 


basic_system 


vfile_status 


compare_ascii 

edm 

indent 

program_interrupt 

qedx 

runoff 

runoff_abs 

set_bit_count 

sort_seg 


Access Control 


dele te_ acl 

delete_iacl_dir 

delete_iacl_seg 

list_acl 

list_iacl_dir 

list_iacl_seg 

set_ acl 

set_iacl_dir 


Segment Manipulation 


set_iacl_seg 


adjust_.bit_count 


Address Space Control 


archive 


add_search_rules 


compare 


change_default_wdir 


compare_ascii 


change_wdii 


copy 


dele te_ sear ch_ rules 


create 


initiate 


delete 


list_ref_names 


delete_ force 


new_proc 


link 


print_default_wdir 


move 


print_proc_auth 


set_bit_count 


print_search_ rules 


sort_seg 


print_wdir 


truncate 


set_search_rules 


unlink 


terminate 


vfile_adjust 


terminate_ ref name 




terminate_ segno 




terminate_single_refname 




where 



Formatted Output Facilities 


Debugging and Perform- 


cancel_daemon_request 


ance Monitoring Facilities 


dprint 


change_error_ mode 


dpunch 


cumulative_page_ trace 


dump_segment 


debug 


list_daemon_requests 


display _ pi 1 io _ error 


print 


dump_ segment 


runoff 


page_trace 


runoff_abs 


probe 


Language Translators, 


profile 


Compilers, Assemblers, 


progress 

ready 

ready_off 


and Interpreters 
apl 
basic 


ready_on 




reprint_error 


basic_ system 


trace 


bind 






trace_stack 


cancel_ cobol_ program 




cobol 


Input/Output System Control 


display _cobol_run_unit 


assign_ resource 


format_ cobol_source 


cancel_ daem o n_ req ues t 


fortran 


close_file 


fortran_abs 


console_output 


indent 


copy_cards 


pll 


display _ pi 1 io _ err or 


pll_abs 


dprint 


profile 


dpunch 


qedx 


file_ output 


run_ cobol 


io_call 


runoff 


line_length 


runoff_abs 


list_daemon_requests 


set_cc 


list_resources 


stop_cobol_run 


print 




prin t_attach_ table 


Object Segment 


print_ request_ types 


Manipulation 


set_cc 


archive 






set_tty 


bind 






unassign_resource 




vfile_adjust 




vfile status 



Command Level Environment 
abbrev 

add_search_rules 
answer 
basic_system 
change_default_wdir 
change_error_ mode 
change_wdir 
console_output 
delete_search_rules 
do 

exec_com 
file_output 
get_com_line 
line_length 
memo 
new_proc 
print_default_wdir 
print_search_rules 
print_wdir 
program_interrupt 
ready 
ready_off 
ready _ on 
release 

reprint_ error 
set_com_line 
set_search_rules 
start 

Communication Among 
Users 

accept_ messages 

defer_ messages 

immediate_ messages 

mail 

print_auth_names 

print_ messages 

send_ message 

who 



Communication with the 
System 

check_info_segs 

help 

how_many_users 

print_motd 

who 

Accounting 
get_quota 
move_quota 
resource_ usage 

Control of Absentee 

Computations 

cancel_abs_request 
enter_ abs_ req uest 
fortran_abs 
how_many_users 
list_abs_ requests 
pll_abs 
runoff_abs 
who 

GCOS Environment 
gcos 

gcos__card_utility 
gcos_sy sprint 
gcos_syspunch 

Miscellaneous Tools 
calc 
decode 
encode 
memo 
progress 
walk subtree 



abbrev, ab 

provides the user with a mechanism for abbreviating 
parts of (or whole) command lines in the normal com- 
mand environment. 

Usage: abbrev 

CONTROL REQUESTS 

,a <abbr> <rest of line> 

add the abbreviation <abbr> to the current profile 
segment. 

.ab <abbr> <rest of line> 

add an abbreviation that is expanded only if found 
at the beginning of a line or directly following a 
semicolon (;) in the expanded line. 

.af <abbr> <rest of line> 

add an abbreviation to the profile segment and 
force it to overwrite any previous abbreviation with 
the same name. 

.abf <abbr> <restofline> 

add an abbreviation that is expanded only at the 
beginning of a line and force it to replace any pre- 
vious abbreviation with the same name. 

.d <abbrl>. . . <abbrn> 

delete the specified abbreviations from the current 
profile. 

.f 

enter a mode (the default mode) that forgets each 
command line after executing it. 

.1 <abbrl> . . . <abbrn> 

list the specified abbreviations with the things they 

stand for. 
.la <letterl> . . . <lettern> 

list all abbreviations starting with the specified 

letters. 

•q 

quit using the abbrev processor. 



enter a mode that remembers the last line expanded 
by abbrev. 

<rest of line> 

show the user how <rest of line> would be ex- 
panded but do not execute it. 



,u <profile> 

specify to abbrev the pathname of a profile seg- 
ment to use. 

•P 

print the name of the profile segment being used. 

.<space> <rest of line> 

pass <rest of line> on to the current command 
processor without expanding it. 

BREAK CHARACTERS 

Break characters (any combinations) must be used to 
delimit abbreviations in a command line. 



tab 

newline 
space 
quote 



semicolon 
vertical bar 
parentheses 
less than 



( ) 

< 

> 



dollar sign $ greater than 

apostrophe ' brackets [ ] 

grave accent v braces { } 

period 

accept_messages, am 

initializes or reinitializes the user's process for accept- 
ing messages sent by the send_ message command. 

Usage: am {-control_args} 

-brief, -bf 
-long 
-print 
-short 

add_name, an 

adds an alternate name to the existing name(s) of an 
entry. 

Usage: an path names 

names 

additional names to be added to the entry. 

add_search rules, asr 

allows the user to change his search rules dynamically. 

Usage: asr pathll { -control_arg path2l} . . 
. pathln { -control_arg path2n} 

pathli 

pathname of a directory to the current search 
rules (certain keywords may also be used). 



control_arg 
-before 
-after 

path2i 

pathname representing current search rule 
(certain keywords may also be used). 

adjust_bit_count, abc 

sets the bit count of segments that for some reason do 
not have the bit count set properly. 

Usage: adjust_bit_ count paths {-control_args} 

-character, -ch 
-long, -lg 

answer 

provides a preset answer to a question asked by 
another command. 

Usage: answer ans {-control_args} command_line 

ans 

desired answer to any question. 

command_line 

any Multics command line. 

control_args 
-brief, -bf 
-times N 

apl 

invokes the Multics APL interpreter. 
Usage: apl 

archive, ac 

combines an arbitrary number of separate segments 
into one single segment. 

Usage: archive key path components 

components 

components of the archive segment, 
key 

listed below by function. 

Table of Contents Operations: 

t print the entire table of contents if no 

components are named by the path 

arguments. 
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tl print the table of contents in long form. 

tb print the table of contents, briefly. 

tlb print the table of contents in long form, 
briefly. 

Append Operations: 

a append named components to the ar- 

chive segment. 

ad append and delete. 

adf append and deleteforce. 

ca copy and append. 

cad copy, append, and delete. 

cadf copy, append, and deleteforce. 

Replace Operations: 

r replace components in, or add com- 

ponents to the archive segment, 
rd replace and delete, 
rdf replace and deleteforce. 
cr copy and replace, 
crd copy, replace, and delete, 
crdf copy, replace, and deleteforce. 

Update Operations: 

u update. 

ud update and delete. 

udf update and deleteforce. 

cu copy and update. 

cud copy, update, and delete. 

cudf copy, update, and deleteforce. 

Delete Operations: 

d delete from the archive those components 

named by the path arguments, 
cd copy and delete. 

Extract Operations: 

x extract from the archive those com- 

ponents named by the path arguments, 
placing them in segments in the storage 
system. 

xf extract and deleteforce. 



assign_resource, ar 

calls the resource control package (RCP) to assign a 
resource to the caller's process. 

Usage: assign_resource type {-control_args} 



type 
tape 



punch 
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disk reader 

console special 

printer 

control_args 

-comment XX, -com XX 
-density N, -den N 
-device XX, -dv XX 
-line_length N, -11 N 
-long, -Ig 
-model N 
-system, -sys 
-track N, -tk N 
-train N, -tnN 
-volume XX, -vol XX 

basic 

invokes the BASIC compiler. 

Usage: basic path {-control_arg} 

-compile 
-time N 

basic_system, bs 

standard BASIC source editor and run dispatcher. 

Usage: basic_ system {path} 

REQUESTS 

delete all 

or 
delete first { last } 

deletes the specified lines. 

exec command_line 

passes the command_line argument to the Multics 
command processor. 

get {path} 

clears the internal buffers so that the user can work 
on a different program. 

line_ number 

deletes that source line if such a line number exists. 

line_ number source_line 

adds or replaces a BASIC source line (source_line) 
in proper sequence. 

list 

prints the entire current internal segment. 
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quit 

exits from basic_system and returns to command 
level. 

rseq {first} {increment} 

resequences the line numbers so that they differ by 
a fixed increment. 

run 

calls the BASIC compiler to run the current 
internal source segment. 

save {path} 

stores the current internal source segment in the 
segment whose pathname is specified by path. 

time N 

establishes a time limit of N CPU seconds on the 
execution of the program. 



bind, bd 

produces a single bound object segment from one or 
more unbound object segments. 

Usage: bind paths {-control_arg} 

-list, —Is 

—map 

-update paths, -ud paths 

calc 

provides the user with a calculator. 

Usage: calc 

REQUESTS 

< expression > 



< variable > = < expression > 



list 

q 

EXPRESSIONS 

order of evaluation 

1 . expression within parentheses 

2. function references 



type value of 
expression, 
assign value of ex- 
pression to variable, 
list variables, 
return to command 
level. 
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3. prefix +, prefix - 
4 * * 

5. *,/ 

6. +,- 

FUNCTIONS. 

sin, cos, tan, atan, abs, In, log 

cancel_abs_request, car 

allows a user to delete a request for an absentee 
computation. 

Usage: cancel_abs_request path {-control_args} 

-all, -a 
-brief, -bf 
—queue N, — q N 

cancel_cobol_program, ccp 

cancels one or more programs in the current COBOL 
run unit. 

Usage: cancel_cobol_ program names {-control_arg} 

control_arg 

-retain_data, -retd 

names 

name specified in the PROG-ID statement. 

cancel_daemon_request, cdr 

cancels a dprint or dpunch request. 

Usage: cancel_daemon_request path {-control_args} 

-all, -a 
-brief, -bf 
—queue N, -q N 
-request_type XX, -rqt XX 

change_default_wdir, cdwd 

sets a specified directory as the user's default working 
directory for the duration of the current process or 
until the next change_default_wdir command is 
issued. 

Usage: change_default_wdir {path} 
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change_error_mode, cem 

controls the amount of information printed by the de- 
fault handler for system conditions. 

Usage: change_error_mode {-control_argsj 

-brief, -bf 
-long, -lg 

change _wdir 

changes the user's working directory to the directory 
specified as an argument. 

Usage: change_wdir {path} 

check_info_segs, cis 

prints a list of new or modified segments. 

Usage: check_info_segs {-control_args} 

-brief, -bf ' ■ 

-call command_line 

-date DT, -dt DT 

-long, -lg 

-no_update, -nud 

-pathname star_name_path, -pn star_name_path 

ciose_fiie, cf 

closes specified FORTRAN and PL/I files. 

Usage: close_file {-control_arg} filenames 



control_arg 




-all 




filenames 




names of the open files. 


cobol 




invokes the COBOL 


compiler. 


Usage: cobol path {-control_args} 


-brief, -bf 


-severityN, -svN 


-check, -ck 


-source, -sc 


-debug, — db 


—symbols, — sb 


-format, -fmt 


-table, -tb 


-list, -Is 


-time, -tm 



-map 
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compare 

compares two segments and lists their differences. 

Usage: compare pathl { loffsetl } path2 { |offset2 } 
{— control_args} 

pathl, path2 

pathnames of segments to be compared. 

offset 1, of fset2 

octal offsets within the segments to be compared. 

control_args 

-length N, -In N 
-mask N 

compare_ascii, cpa 

compares two ASCII segments and prints the changes 
made to the segment specified by pathl to yield the 
segment path2. 

Usage: compare_ascii pathl path2 {minchars} 
{minlines} 

path 1 , path2 

pathnames of segments to be compared. 

minchars 

decimal number specifying the minimum num- 
ber of characters that must be identical before 
the segments are again assumed to be "in sync" 
after a difference in the two segments. 

minlines 

decimal number specifying the minimum num- 
ber of lines that must be identical. 

console _ output, co 

directs the user_output to the terminal (See 
file_output.) 

Usage: console_output 

copy, cp 

creates copies of specified segments and/ or multiseg- 
ment files in the specified directories with the speci- 
fied names. 

Usage: copy pathl 1 {path2j} . . . pathln {path2n} 
{— control_args} 
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pathli 

pathname of segment to be copied. 

path2i 

pathname of a copy to be created from pathli. 

control_args 
-acl 
-all, -a 
-brief, -bf 
-name, -nm 

copy_cards 

copies specified card image segments from system 
pool storage into a user's directory. 

Usage: copy_cards deck_name {path} 

deck_name 

name entered on deck_id card. 

create, cr 

creates a. storage system segment in a specified direc- 
tory (or in the working directory). 

Usage: create paths 

create_dir, cd 

creates a specified storage system directory branch in a 
specified directory (or in the working directory). 

Usage: create_dir paths { - control_args J- 

-access_class XX, -ace XX 
—quota N 

cumulative_page_trace, cpt 

accumulates page trace data so that the total set of 
pages used during the invocation of a command or sub- 
system can be determined. 
Usage: cumulative_page_trace command_line 
{-control_args} 

command_line 

character string to be interpreted as a command 
line. 



control_args 
-count, -ct 



-reset, -rs 
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-flush 




-short, -sh 




-interrupt N, 


-intN 


-sleep N 




-long, -lg 




-timers 




-loop N 




-total, -tt 




-print, -pr 




- trace path 


debug, db 








interactive debugging aid to be used in the Multics 


environment. 







Usage: debug 

DATA REQUESTS 

Format of Data Request 

< generalized address > < operator > < operands > 

Generalized Address 

[/segment name/ ] [offset] [segment ID] 

[relative offset] 



/seg name I 


offset 


segment ID 


pathname 


number 


&t 


text 


ref name 


symbol 


&s 


stack 


seg number 




&1 


linkage 


&n seg name 




&an 


source line 


seg$entry 




&pn 


Pi 


irameter 






&i~ 


internal static 


rel offset 










number 










register 










Operators 


Operands 




Output Modes 


. print 


operands 




o 


octal 


= assign 


input list 




h 


half -carriage octal 


< set break 


function 




d 


decimal 


> transfer 


list 




a 


ASCII 


:= call 






i 

P 
s 
1 

n 
e 
f 
b 

g 


instruction 

pointer 

source statement 

code for line 

number 

no output 

floating point 

floating point 

bit string 

graphic 
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CONTROL REQUESTS 

Multics command 
.ai,m print argument i in mode m 

(modes: o, p, d, a, b, 1, e, f, ?) 
.be alj= A =}a2 make conditional all breaks of de- 
fault object segment 
.bcial{= ^=}a2 make conditional break i 
.bd name/no. set (or print) default object segment 
.be <line> execution line for all breaks of the 

default object segment 
.bei <line> execution line for break i 
.bge <line> execution line for all breaks 
.bgl list all breaks 

.bgn enable all breaks 

.bgo disable all breaks 

.bgr reset all breaks 

.bgt <line> establish a temporary global command 
.bl list the breaks of the default object 

segment 
.bli list break i 

.bn enable the breaks of the default 

object segment 
.bni enable break i 

.bo disable the break of the default 

object segment 
.boi disable break i 

.bp print names of all segments with 

breaks 
.br reset the breaks of the default object 

segment 
.bri reset break i 

.bsi n set skips of break i to n 

.C use crawlout registers 

.c,i continue after break fault (ignore 

next i break fault) 
.cr,l continue, in normal mode 

.ct,i continue, in temporary break mode 

.d or .D print default values 

,f use registers from last fault 

.i set stack to ith frame 

.+i or .-j pop or push stack by i frames 

.mb change to brief output mode 

.ml change to long output mode 

.q return from debug to caller 

.ti,n trace stack from frame i for n frames 
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decode 

reconstructs an original segment from an enciphered 
segment according to a key that need not be stored in 
the system. (See encode.) 

Usage: decode pathl { path2 } 

pathl 

pathname of enciphered segment. 

path2 

pathname of deciphered segment to be 
produced. 

defer_messages, dm 

suspends printing of messages sent by the 
send _ message command on the user's terminal. 

Usage: defer_messages 

delete, dl 

deletes the specified segments and/or multisegment 
files. 

Usage: delete paths 

delete_acl, da 

removes entries from the ACLs of segments, multi- 
segment files, and directories. 

Usage: delete_acl {path} {User_ids} {-control_args} 

-all, -a 
-brief, -bf 
—directory, — dr 
-segment, -sm 

delete_dir, dd 

deletes the specified directories (and any segments, 
links, and multisegment files they contain). 

Usage: delete_dir paths 

delete_force, df 

deletes the specified segments or multisegment files, 
regardless of whether or not the safety switch is on. 

Usage: delete_force paths 
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delete_iacl_dir, did 

deletes entries from a directory initial ACL in a speci- 
fied directory. 

Usage: delete_iacl_dir {path} {User_ids} 
{-control_args} 

-brief, -bf 
-ring N, -rg N 

delete_iacl_seg, dis 

deletes entries from a segment initial ACL in a speci- 
fied directory. 

Usage: delete_iacl_seg {path} {User_ids} 
{-control_args} 

-brief, -bf 

-ringN, -rg N 

delete_name, dn 

deletes specified names from entries that have 
multiple names. 

Usage: delete_name paths 

delete_search_mles, dsr 

allows the user to delete current search rules. 

Usage: delete_search_ruies paths 

dial, d 

connects an additional terminal to an existing process. 

Usage: dial dial_id Person_id.Project_id 

dial_id 

keyword that uniquely specifies a logged-in 
process that is accepting dial connections. 

Person_id.Project_id 

the Person_id and Project_id of the process 
the user wishes to connect to. 

display _cobol_run_unit, dcr 

displays the current state of a COBOL run unit. 
Usage: display_cobol_run_unit {-control_args} 

-all, -a 
-files 
-long, -lg 
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display_pllio_error, dpe 

describes the most recent file on which a PL/I I/O 
error was raised and displays diagnostic information 
associated with that type of error. 

Usage: display_pllio_error 



do 

expands a command line according to the arguments 
supplied following the command string. 

Usage: do "commandstring" {-controlargs} 

command_ string 

a command line in quotes. 

control_args 

a character string argument to replace a param- 
eter designated by &i in command_string. 

modes 

-absentee 
-brief, -bf 
-go 

-interactive 
-long, -lg 
-noeo 



dprint, dp 

queues specified segments and/or multisegment files 
for printing on the line printer. 

Usage: dprint {-control_args} {paths} 

-access_label, -albl -no_endpage, -nep 

-bottom_label XX, - no_ label, -nlbl 

-blbl XX -page_length N, 
-brief, -bf -pi N 

-copyN, -cpN -queue N, -q N 

-delete, -dl -request_type XX, 
-destination XX, -ds XX -rqt XX 

-header XX, -he XX -single, -sg 

-indent N, -in N -top_label XX, 
-label XX, -lbl XX -tlbl XX 

-line_length N, -11 N -truncate, -tc 
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dpunch, dpn 

queues specified segments and/or multisegment files 
for punching by the card punch. 

Usage: dpunch {-control_args} {paths} 



-brief, -bf 
-copy N, -cp N 
-delete, -dl 

-destination XX, -ds XX 
-header XX, -he XX 
— mcc 



—queue N, — q N 
-raw 
-request_type XX, 

-rqt XX 
-7punch, -7p 



dump_segment, ds 

prints, in octal format, selected portions of a segment. 

Usage: dump_ segment path { first } { num } 
{-control_arg} 



first 

the octal number of the first word to be 
dumped. 

num 

the octal number of words to be dumped 

control_args 

-address, -addr 
-bed 
-block N 



-character, -ch 
-header, -he 
-long, -lg 



-name, -nm 
-no_ address, -nad 
— no_header, -nhe 
-no_offset, -nofs 
-offset N,-ofsN 
—short, — sh 



edm 

invokes a simple Multics context editor. 

Usage: edm {path} 
REQUESTS 



-N 



cN/sl/s2/ 



enter input mode; exit when a line 

with only "." is typed. 

back up N lines. 

enter "comment" mode; exit when a 

line with only "." is typed. 

print current line number. 

go to bottom of file, enter input 

mode. 

change all occurrences of string "si" 

to "s2" for N lines. 
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d N deletes N lines, 

updelete delete all lines above current line. 

E line execute "line" as a Multics com- 

mand line, 
f string find a line beginning with "string". 

i line insert "line" after current line, 

merge path insert segment "path" after current 

line, 
move M N beginning with line M, remove N 

lines and insert them after the current 

line, 
k enter brief mode (no response after f, 

n, 1, c, and s requests). 
1 string locate a line containing "string", 

n N move down N lines, 

p N print N lines, 

q exit from edm. 

qf exit directly from edm with no 

question, 
r line replace current line with "line". 

sN/sl/s2/ same as "c". 

t go to top of file. 

v enter verbose mode (opposite of k 

request), 
w path write edited copy of file into "path", 

upwrite path write all lines above current line into 

"path". 

encode 

enciphers a segment's contents according to a key that 
need not be stored in the system. (See decode.) 

Usage: encode path 1 {path2} 

pathl 

pathname of segment to be enciphered. 

pathl 

pathname of the enciphered segment to be 
produced. 

enter, e 
enterp, ep 

used by anonymous users to gain access to Multics. 

Usage: enter {anonymous_name}Project_id 
{-control_args} 
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anonymous_name 

treated like person identifier. 

Project_id 

identification of the user's project. 

control_args 
-brief, -bf 
-force 

-home_dir path, -hd path 
— no_preempt, -np 
-no_print_off, -npf 
-no_start-up, -ns 
-print_off, -pf 
-process_ overseer path, — po path 

enter_abs_request, ear 

requests that an absentee process be created. 

Usage: enter_abs_ request path {-control_args} 

-arguments XX, -ag XX 

-brief, -bf 

-limit N, li N 

— output_file path, —of path 

-queue N, 

-restart, -rt 

-time DT, -tm DT 

exec_com, ec 

executes a series of command lines contained in a 
segment. 

Usage: exec_com path { optional_args} 

optional_args 

character strings substituted for &i in the 
exec_com segment. 

Each &i (where i is an integer) in the exec_com 
segment is replaced by the corresponding argu- 
ment to the exec_com command; &ec_name is 
replaced by the entryname portion of the 
exec_com pathname without the ec suffix; &0 
is replaced by the path argument to the 
exec com command. 



CONTROL STATEMENTS 
&label location 
&goto location 



identifies location, 
transfers control to &label 
specified. 
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&attach attaches user_input to 

exec_com segment. 

&detach detaches user_input. 

&input_line on writes input lines on 

user_output 

&input_line off does not write out input lines. 

&command_line on writes command lines on 
user_output prior to 
execution. 

&command_line off does not write out command 
lines. 

&ready_on invokes ready message after 

execution of each command 
line. 

&ready_off turns off ready message; 

default. 

&print char_string prints char_string on 

user_output. 
&quit returns exec_.com to caller. 

&if [ACTIVE_FUNCTION -argl . . . -argn -] 
executes & then clause if 
ACTIVE_FUNCTION returns 
"true"; executes &else clause 
if ACTIVE_FUNCTION re- 
turns "false"; otherwise error. 
Each argi can also be an active 
function. 
&then THEN_CLAUSE 

can include a command line, 
input line, null statement, and 
most control statements. 
&else ELSE_CLAUSE can include a command line, 
input line, null statement, and 
most control statements. 

file_output, fo 

directs the user_output to a segment. (See 
console_output.) 

Usage: file_ output {path} 

format_cobol_source, fcs 

converts pseudo free-form COBOL source programs to 
the standard fixed-format COBOL source programs. 

Usage: format_cobol_source pathl path2 
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pathl 

pathname of input segment containing pseudo 
free-form COBOL source code. 

path2 

pathname of output segment containing con- 
verted fixed-format COBOL source. 

fortran, ft 

invokes the FORTRAN compiler. 

Usage: fortran path {-control_args} 

-brief, -bf -optimize, -ot 

-brief_table, -profile, -pf 

_bftb -severityN, -svN 

-card -source, -sc 

-check, -ck -subscriptrange, -subrg 

-convert -symbols, -sb 

-debug, -db -table, -tb 

-list, -Is -time, -tm 
—map 

fortran_abs, fa 

submits an absentee request to perform FORTRAN 
compilations. 

Usage: fortran_abs paths {-ft_args} {-dp_args} 
{-abs_control_args } 

ft_args 

control arguments accepted by the fortran 
command. 

dp_args 

control arguments (except -delete) accepted 
by the dprint command. 

abs_control_args 
-queue N, — q N 
-hold 
-output_file path, -of path 

fs_chname 

manipulates strangely named segments because none of 
the special command system symbols (e.g., *, >) are 
interpreted. When oldname and newname are not null 
strings, fs_chname is equivalent to using the rename 
command; null string for oldname is equivalent to 
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using the add_name command; null string for a 
newname is equivalent to using the delete_name 
command. 

Usage: fs_chname dir_name entryname oldname 
newname 

dir_name 

directory name portion of the segment. 

entryname 

entryname portion of the segment. 

oldname 

old entryname to be deleted. 

newname 

new entryname to be added. 



gcos, gc 

invokes the GCOS environment simulator to run a 
single GCOS job, immediately, in the user's process. 

Usage: gcosjob__deck_path {-control_args} 

job_deck_path 

pathname of segment containing a GCOS job 
deck. 

control_args 

listed below by function. 

Input Specifications: 

-ascii, -aci — nocanonicalize, — nocan, -no 
-gcos, -gc —truncate, -tc 

Output Specifications: 

—dprint, —dp —hold, — hd 

-dprint_options "options", -list, -Is 

-dpo "options" -lower_case, -lc 

-dpunch, -dpn -raw 

-dpunch_ options "options", 

— dpno "options" 

Creation of Files: 

—brief, -bf — no_bar, -nobar, -nb 

-continue, -ctu -syot_dir path, -sd path 

-debug, -db -temp_dir path, -td path 

-job_id id, -id id -userlib 
-long, -lg 
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gcos_card_utility, gcu 

copies GCOS card image files, altering their format, 
content, and medium, as specified by the user. 



Usage: 



gcu input_ specification output_specification 

input_ specification, output^specif ication 

pathnames (or tape numbers) and control argu- 
ments. Control arguments are listed below by 
function. 



Input and Output Specifications: 
-input, —in 
—output, —out 



File Formats: 

-ascii, — aci 
-comdk, -cdk 
-gcos_ascii, -gca 
-gcos, -gc 



-no_canonicalize, —no 
-raw 
-tabs N 
-truncate, -tc 



File Contents: 

-imcv XX 
-library XX, 



-lib XX 



Tape Files: 

-attached, -att -tape? N 

-detach, -det -tape9 N 

-label XX, -lbl XX -retain, -ret 
-tape N 

Partial Copying: 

-count N, -ct N 
-first N, -ft N 
-last N, -It N 

Output File Duplication: 
-append, -app 

Input and Output Lists: 

-all 

-file_input path, -fi path, 
-file path 

Terminal Output: 
-brief, -bf 
-debug, -db 
-long, -lg 



-list XX, -Is XX 
-name, -nm 
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gcos_sysprint, gsp 

converts a print file (either SYSOUT or simulated 
printer) produced by the GCOS environment simu- 
lator, from BCD to ASCII. 

Usage: gcos_sysprint input_path {output_path} 
{-control_args} 

input_path 

pathname of a print file produced by the 
simulator. 

output_path 

pathname into which the ASCII output lines 
are written. 

control_args 

— lower_case, — lc 
-temp_dir path, -td path 

gcos_syspunch, gspn 

converts a GCOS standard system format file, contain- 
ing BCD and binary card images, to a format suitable 
for punching using the Multics dpunch command with 
the -raw argument. 

Usage: gcos_syspunch path 

get_com_line, gel 

prints on the user's terminal the maximum length 
allowed for an expanded command line. 

Usage: get_com_line 

get_quota, gq 

returns information about the secondary storage 
quota and pages used for a specified directory. 

Usage: get_ quota paths {— control_arg} 

-long, -lg 

help 

assists users in obtaining online information about 
such things as commands, subsystems, system status, 
or changes. 

Usage: help {name} {-control_args} 
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rest 
skip 

title 



name 

the name of an info segment which refers to a 
command or general topic. 

control_args 
-header, -he 

-pathname path, -pn path 
-search XX, -sh XX 
-section XX, -sc XX 
-title 

REQUESTS 

Each info segment is divided into paragraphs delimited 
by double blank lines. After each paragraph, help asks 
"More help?" The user may reply: 

yes print next block 

no print no more from this 

segment 

rest of this segment 
skip next block and 
proceed 

print remaining section 
titles, no questions 
quit exit from help 

search { XX }, sh { XX } search forward for string 

XX 
section { XX }, sc { XX } find section named XX 

how_many_users, hmu 

prints how many users are currently logged in. 

Usage: how_many_users {args} {-control_args} 

control_args 

—absentee, -as 
-brief, -bf 
-long, -lg 

args 

Person_id 

.Projectid 

Person_id.Project_id 

immediate_messages, im 

restores the immediate printing of messages sent by 
the send_message command. 

Usage: immediatemessages 
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indent, ind 

improves the readability of a PL/I source segment by 
indenting it according to a set of standard conventions. 
Usage: indent oldpath { newpath } {- control_args } 

oldpath 

pathname of input PL/I source segment. 

newpath 

pathname of output PL/I source segment. 

con trol_ args 
-brief, -bf 
-comment N, -cm N 
-indent N, -in N 
-lmargin N, -lm N 

initiate, in 

enables users to initiate segments directly, i<e., not 
using the normal search rules. 
Usage: initiate path {ref_names} {- control _arg} 

ref_ names 

reference names for the segment. 

control_arg 
-long, -lg 

io_call, io 

performs an operation on a designated I/O switch. 

Usage: io attach switchname modulename { args } 

Usage: io detach switchname 

Usage: io open switchname mode 

Usage: io close switchname -. 

Usage: io get_line switchname | n } {- control_args $ 

Usage: io get^ chars switchname n {-control_args } 

Usage: io put_ chars switchname { string} 

{-control_args} . 

Usage: io read_record switchname n {-control_args J- 

Usage: io write_record switchname { string } 
{-control_args } 

Usa°e: io rewrite_record switchname { string } 
{-control_args} 

Usage: io delete_record switchname 

Usage: io position switchname type 

Usage: io seek_key switchname key 
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Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 



io read_key switchname 

io read_length switchname 

io control switchname order 

io modes switchname {string} {-brief} 

io find_iocb switchname 

io look_iocb switchname 

io move_attach switchname switchname2 

io destroy_iocb switchname 

io print_iocb switchname 

switchname 

name of the I/O switch. 

module name 

name of I/O module used in attachment. 



args 



any arguments accepted by the I/O module 
used in attachment. 



mode 

stream_input, si 
stream_output, so 
stream_input_output, 

sio 
sequential_input, sqi 
sequential_ output , 

sqo 
sequential inp ut _ out- 
put, sqio 
sequential_update, 
squ 



keyed_sequential__input, 

ksqi 
key ed_ sequential_output, 

ksqo 
keyed_ sequential_up- 

date, ksqu 
direct_ input, di 
direct_ output, do 
dire ct_ update, du 



decimal number. 

string 

any character string. 



type 

bof, -1 
eof, 1 

f N 
rN 
othern 



set to beginning of file. 
set to end of file, 
set forward N records or lines, 
set back N records, 
number whose interpretation de- 
pends on I/O module being used. 



key 



string of ASCII characters with 
0< length < 256. 
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order 

one of the orders accepted by the I/O module 
used in the attachment of the I/O switch. 

control_aigs 
-brief, -bf 
—lines 
-nl 
-nnl 

-segment path {offset}, -sm path {offset} 
-segment path {length}, -sm path {length} 
-segment path {offset} {length}, 
-sm path {offset} {length} 

line_length, 11 

sets the maximum length of a line output to the de- 
vice that a process is connected to through the 
user_output I/O switch. 

Usage: line_length maxlength 

maxlength 

maximum length of line. 

link, Ik 

creates a storage system link with a specified name in < 
specified directory pointing to a specified segment or 
directory. 

Usage: link pathll path21 . . . pathln {path2n} 

pathli 

pathname of the segment to which path2i is to 
point. 

path2i 

pathname of the link to be created. 

list, Is 

prints information about entries contained in a 
single directory. 

Usage: list {entrynames} {-control_args} 

entry names 

names of entries to be listed. 

control_args 

listed below by function. 

Directory: 

-pathname path, -pn path 
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Entry Type: 

-all, -a 

-branch, -br 

-directory, -dr 

-file, -f 

-link, -Ik 

-multisegment_file, -msf 

-segment, -sm 
Columns: 

—count, -ct 

-date_time_contents_modified, -dtcm 

-date_time_entry_modified, -dtem 

-date_time_used, — dtu 

-length, -In 

-link_path, -lp 

-mode, -md 

-name, -nm 

-record, -rec 

Totals/Header Lines: 

- no _ header, -nhe 

-total, -tt 
Multiple-Name Entries: 

-match 

-primary, -pri 

Entry Order: 
—reverse, — rv 
-sort XX, -sr XX 

Entry Exclusion: 

-exclude entryname, -ex entryname 
-first N, -ft N 
-from DT, -fm DT 
-toDT 

Output Format: 
-brief, -bf 
-short, -sh 

list_abs_requests, lar 

prints information/about absentee requests. 

Usage: list_abs_requests {-control_args} 

-all, -a 
-long, -lg 
-queue N, -q N 
-total, -tt 
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list_acl, la 

lists the ACLs of segments, multisegment files, and 
directories. 

Usage: list_acl {path} {User_ids} {-control_args} 

-brief, -bf 
-directory, -dr 
-ring_brackets, -rb 
-segment, -sm 

list_daemon requests, Idr 

prints information about dprint and dpunch requests. 

Usage: list_daemon_requests {-control_args} 

-all, -a 
-long, -lg 
-queue N, -q N 
-request_type XX, -rqt XX 
-total, -tt 

list_iacl_dir, lid 

lists some or all of the entries on a directory initial 
ACL in a specified directory. 

Usage: list_iaci_dir {path} {User_ids} 
{-control_args} 

-brief, -bf 
—ring N, — rg N 

list_iacl_seg, lis 

lists entries on a segment initial ACL in a specified 
directory. 

Usage: list_iacl_seg { path } { User_ids } 
{-control_args} 

-brief, -bf 
—ring N, -rg N 

list_ref_names, lrn 

lists the absolute pathname and reference names 
associated with a segment. 

Usage: list_ref_ names paths {-control_args} 

-all, -a 
-brief, -bf 
-from N -to N 
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list_resources, Ir 

lists resources that are assigned or attached to the 
calling process by the resource control package (RCP). 

Usage: list_resources {-control_args} 

-assignments, -asm 
-attachments, — atm 
-device XX, ~dv XX 
-long, -lg 
-type XX, -tp XX 



login, 1 

used to gain access to the system. 

Usage: login Person_id { Projected } {- control_args } 

Person_id 

user's personal identifier. 

Project_id 

identification of the user's project. 

control_args 

-authorization XX, -no_preempt, -np 

-auth XX -no_print_off, -npf 

-brief, -of -no_start_up, -ns 

-change_de- -no_warning, -nw 

fault_auth, -cda -outer_module p, 

— change_de- -om p 

fault_ project, -cdp -print_off, -pf 

-change_pass- — process_overseer 

word, -cpw path, -po path 

-force -ring N 

-generate _ pass- -subsystem path, 

word, -gpw -ss path 

-home^dir path, -terminal_type XX, 

-hd path -t tp XX 
-modes XX 



logout 

terminates a user session. 

Usage: logout {-control_args} 

-brief, -bf 
-hold 
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mail, ml 

sends a message to another user or prints messages 
in a mailbox. 

Usage: (sending) 

ml path Person_idl Project_idl . . 
{Person_idn} {Project_idn} 

(printing) 

ml {path} {-control_arg} 

-brief, -bf 

SENDING 

If path is *, mail responds with "Input:" and 
accepts lines from the terminal until a line consisting 
of a period (.) is typed. 

PRINTING 

If no path argument is given, the contents of the de- 
fault mailbox is printed. 

CREATING A MAILBOX 

A default mailbox is created automatically the first 
time a user types "mail' 1 ; the default mailbox is: 

>user_dir_dir> Projected >Person_id>Person_id.mbx 

MAP 

tells system user has terminal that generates only 
uppercase characters; system then maps each typed 
character to lowercase unless it is preceded by a 
backslash (\). 

Usage: MAP 

memo 

maintains an interactive notebook and reminder list. 

Usage: memo {-control_arg } {optional_args} 
{ memo_text } 

control_args 
-brief, -bf 
-delete, -dl 
-list, -Is 
-off 
-on 

-pathname path, -pn path 
-print, -pr 
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optional_args 

memo_ number 

—alarm, -al 

-call 

-date DT, -dt DT 

—invisible, — iv 

-match XX 

-repeat intvl, -rp intvl 

-time DT, -tm DT 
memo_text 

text of memo being set. 

move 

moves a designated segment or multisegment file (and 
its ACL and all names on the designated file) to a new 
position in the storage system hierarchy. 

Usage: move pathll { pafh21 }. . . pafhln { pafh2n} 
{-control_arg } 

pathli 

pathname of segment to be moved. 

path2i 

pathname to which pathli is to be moved. 

control_arg 
-brief, -bf 

move_quota, mq 

moves storage quota between two directories, one 
immediately inferior to (contained in) the other. 

Usage: move_quota pathi quota_changel . . 
. pathnquota_changen 

pathi 

pathname of directory. 

quota_changei 

number of records to be moved between the 
containing directory quota and the pathi quota. 

new_proc 

destroys the user's current process and creates a new 
one, using the control arguments given initially with 
the login command, and the optional control argument 
to the new_proc command itself. 

Usage: new_proc {-control_arg } 

-authorization XX, -auth XX 
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page_trace, pgt 

prints a recent history of page faults and other system 
events within the calling process. 
Usage: page_trace {count} {-control_arg} 

count 

prints the last count of system events recorded 
for the calling process. 

control_arg 
-long, -lg 

pll 

invokes the PL/I compiler. 

Usage: pll path {-control_args} 

-brief, -bf -profile, -pf 

-brief _ table, -bftb -severityN, -svN 

-check, -ck -source, -sc 

-debug, -db -symbols, -sb 

-list, -Is -table, -tb 

-map -time, -tm 
-optimize, -ot 

pll_abs, pa 

submits an absentee request to perform PL/ 1 
compilations. 

Usage: pll_abs paths {-pll_args} {-dp_args} 
{-abs_control__args } 

pll_abs 

control arguments accepted by the pll 
command. 

dp_args 

control arguments (except -delete) accepted 
by the dprint command. 

abs_control_args 
-queue N, -q N 
-hold 
-output_file path, - of path 

print, pr 

prints a specified ASCII segment on the user's 
terminal. 
Usage: print path { begin } { end } 
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begin 



the line number that identifies where printing 
begins. 

end 

the line number that identifies where printing 

ends. 

print_attach_table, pat 

prints a list of attached I/O switches, their attach 
descriptions, and opening mode. 
Usage: print_attach_ table {switch_ names} 

switch_names 

names of I/O switches. 

print_auth_names, pan 

prints the names of the sensitivity levels and access 
categories defined for the installation. 
Usage: print_auth_names {-control_args} 

-all, -a 
-brief, -bf 
-category, -cat 
-level 

print_default_wdir, pdwd 

prints out the pathname of the current default work- 
ing directory. 
Usage: print_default_wdir 

print_messages, pm 

prints any interprocess messages that were received 
(and saved in the user's mailbox) while the user was 
not accepting messages. 
Usage: print_ messages 



print_motd, pmotd 

prints out changes to the message of the day since the 
last time the command was called. 

Usage: print_motd 
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print_proc_auth, ppa 

prints the access authorization of the current process 
and current system privileges (if any). 

Usage: print_proc_aufh {-control_args} 

-all, -a 
-long, -Ig 

print_request_ types, prt 

prints a list of all request types handled by the I/O 
daemon. 

Usage: print_request_ types {-control_args} 

-access_name XX, -an XX 
-brief, -bf 
-gen_type XX, -gt XX 

print_search_rules, psr 

prints the search rules currently in use. 

Usage: print_search_rules 



print_wdir, pwd 

prints the pathname of the current working 
directory. 

Usage: print_wdir 

probe, pb 

provides symbolic, interactive debugging facilities for 
programs compiled with PL/I, FORTRAN, or COBOL. 
The program to be debugged must be compiled with 
the -table control argument. 

Usage: probe { procedure_name } 

procedure_name 

the symbolic name of the form, 

reference_ name $offset_ name, of an entry to a 

procedure or subroutine. 



REQUESTS 
after 
before 
call 

continue 
execute 



a Set a break after a statement. 

b Set a break before a statement, 

cl Call an external procedure, 

c Return from probe, 

e Execute a Multics command. 
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goto 


g 


halt 


h 


if 


(none) 


let 


1 


mode 


(none) 


pause 


pa 


position 


ps 


quit 


q 


reset 


r 


source 


sc 


stack 


sk 


status 


St 


step 


s 


symbol 


sb 


use 


u 


value 


V 


where 


wh 



while 



wl 



Transfer to a statement. 
Stop the program. 
Execute commands if condi- 
tion is true. 

Assign a value to a variable. 
Turn brief message mode on 
or off. 

Stop a program once. 
Examine a specified state- 
ment or locate a string in the 
program. 

Return to command level. 
Delete one or more breaks. 
Display source statements. 
Trace the stack. 
Display information about 
breaks. 

Advance one statement and 
halt. 

Display the attributes of a 
variable. 

Examine the block specified. 
Display the value of a variable. 
Display the value of probe 
pointers. 

Execute commands while 
condition is true. 



profile 

prints information about the execution of each state- 
ment in PL/I or FORTRAN programs. The -profile 
control argument must have been used when the 
program was compiled. 

Usage: profile paths {-control_args} 

-brief, -bf 
-long, -lg 
-print, -pr 
-reset, -rs 

program_interrupt, pi 

allows a subsystem which establishes a handler for 
program_interrupt to regain control after a QUIT, 
fault, or call out by the use of this command. 

Usage: program_interrupt 
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Usage: 



progress, pg 

executes a specified command line and prints infor- 
mation about how its execution is progressing in 
terms of CPU time, real time, and page faults. 

progress {-control_arg} { command _ line} 

control_arg 
-brief, -bf 
— cput N 
-off 
—on 

-output_ switch XX, -os XX 
-realt N 

command_line 

character string created by concatenating all the 
arguments to progress (excluding the first if it 
is a control argument) with blanks between 
them. The string is executed as a command line. 

qedx, qx 

context editor used to create and edit ASCII segments 
in Multics. 
Usage: qedx {path} { optional_args } 

path 

pathname of an ASCII segment from which the 
editor takes its initial instructions. 

optional_args 

appended, each as a separate line, to the buffer 
named args. 

REQUESTS 

Listed below in four categories giving: format, default 
in parentheses, and brief description. For value of 
ADR, see "Addressing" below; regexp, see "Regular 
Expression." 

INPUT REQUESTS 

These requests enter input mode and must be termi- 
nated with \ f. 
ADRa (.a) append lines after specified 

line. 
ADRl,ADR2c (.,.c) change existing line(s); de- 

lete and replace. 
ADR1 (.i) insert lines before speci- 

fied line. 
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BASIC EDIT REQUESTS 

ADRl,ADR2d (.,.d) delete line(s). 

ADRl,ADR2p (.,.p) print line(s). 

ADR= (.=) print line number. 

q exit from qedx editor. 

ADRr path ($r path) append contents of path 

after specified line. 

ADRl,ADR2s/regexp/string (. , .s/regexp/string/) 

substitute every regexp in 
the line(s) with string. If 
string contains &., & is re- 
placed by regexp. First 
character after s is de- 
limiter; it can be any char- 
acter not in either regexp 
or string. 

ADRl,ADR2w {path}(l ,$w) 

write lines into segment 
names path; if path omit- 
ted, default pathname used. 

/regexp/ set the value of "." to the 

first line following the cur- 
rent line that contains 
regexp and print the line. 

EXTENDED EDIT REQUESTS 

e < command line> execute command line 

without leaving editor. 

ADRl,ADR2gX/regexp/(l ,SgX/rege xp/) 

perform operation on lines 
that contain regexp; X 
must be d for delete, p for 
print, or = for print line 
numbers. 

ADRl,ADR2vX/regexp/(l,$vX/regexp/) 

perform operation on lines 
that do not contain regexp; 
X must be d for delete, p 
for print, or = for print 
line numbers. 

BUFFER REQUESTS 

b(X) go to buffer names X. 

ADRl,ADR2m(x)(. , .m(X)) 

move line(s) from current 
buffer into buffer names X. 
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x give the status of all buffers 

in use. 
ADRn (.n) set the value of "." to line 

addressed. 
ADR" (.") ignore rest of line; used for 

comments. 

ADDRESSING 

Most editing requests are preceded by an address speci- 
fying the line or lines in the buffer on which the re- 
quest is to operate. Lines in the buffer can be 
addressed by absolute line number; relative line num- 
ber, i.e., relative to the "current" line; and context. 
Current line is denoted by period (.); last line of buffer, 
by dollar sign ($). 

REGULAR EXPRESSION 

The following characters have specialized meanings 

when used in a regular expression. The user can rein- 

voke the last used regular expression by giving a null 

regexp (/ /). 

* signifies any number (or none) of the preceding 
character. 

A when used as the first character of a regular expres- 
sion, signifies the character preceding the first 
character on a line. 

$ when used as the last character of a regular expres- 
sion, signifies the character following the last char- 
acter on a line. 

. matches any character on a line. 

ESCAPE SEQUENCES 

\ f exit from input mode and terminate the input 

request. 
\ c suppress the meaning of the escape sequence or 

special character following it. 
\ b(X) redirect editor stream to read subsequent input 

from buffer X. 
\ r temporarily redirects the input stream to read 

a single line from the user's terminal. 

ready, rdy 

types out an up-to-date ready message giving the time 
of day as well as the amount of CPU time and page 
faults used since the last ready message was typed. 

Usage: ready 
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ready_off, rdf 

turns off the ready message. 
Usage: ready _ off 

ready_on, rdn 

prints a ready message after each command line has 
been processed. 

Usage: ready_on 

release, rl 

releases the stack history that was automatically pre- 
served after a quit signal or unclaimed signal. 

Usage: release {-control_arg} 

-all, -a 

rename, rn 

replaces an entry name by a specified new name, with- 
out affecting any other names the entry might have. 

Usage: rename pathl namel . . . pathn namen 

path! 

old name that is to be replaced. 

namei 

new name that replaces the entryname portion 

of pathi. 

reprint_error, re 

prints information, from the system condition handler, 
about a condition that has already been handled and 
for which stack history is preserved. 

Usage: reprint_error {-control_args} 

-all, -a 
-brief, -bf 
-depth N, -dh N 
-long, -lg 

resource_usage, ru 

prints a report of resource consumption for current 
billing period. 
Usage: resource_usage {-control_arg} 

-brief, -bf 
-long, -lg 
-total, -tt 
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run_cobol, re 

initiates execution of a COBOL run unit in a specified 
"main program." 

Usage: run_cobol name {-control_args} 

name 

reference name or pathname of the "main 
program" to be initiated. 

control_args 

-cobol_ switch N, -cs N 
— no_stop_run, — nsr 

runoff, rf 

types out text segments in manuscript form. 

Usage: runoff paths {-control_axgs} 



control_args 
-ball N, -bl N 
-character, -ch 
-device N, -dv N 
-from N, — fm N 



-page N, -pg N 
-parameter arg, 

-pm arg 
-pass N 



-hyphenate, -hph -segment, -sm 

-indent N, -in N -stop, -sp 

-no_pagination, -to N 

-npgn -wait 5 -wt 
—number, — nb 

CONTROL WORDS 

Conventions to specify arguments of control requests. 

# integer constant 

c character 

cd character pair 

exp expression (either numeric or string) 

n integer expression 

± ± indicates update by n; if sign not present, set 

to n 

f segment name 

t title of the form 'partl'part2'part3' 

CONTROL REQUESTS 

If the request has a default, it is in parentheses fol- 
lowing the definition. 



.ad 
.ax 
.bp 



right justify text (on) 
arabic page numbers (arabic) 
begin new page 
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.br 
.cc c 

.ce n 
.ch cd . . 
.ds 

.ef # t 
.eh#t 
.eq n 
.ex text 
.fht 

.fi 

.fo # t 
.frc 



.ft 

.gb xxx 
.gf xxx 
.he #t 
.if f exp 



.m ±n 
.la xxx 
in 
.11 ±n 
.ma ±n 
.mp +n 
.ms ±n 
.ml ±n 
.m2 ±n 

.m3 +n 

.m4 ±n 
.na 
,ne n 

.nf 

.of # t 
.oh#t 
•op 



break, begin new line 

change special character from % to 

c(%) 

center next n lines (1) 

note "c" in chars segment as "d" 

double space (off) 

defines even footer line # 

defines even header line # 

next n lines are equations (1) 

call command processor with "text" 

format of footnote demarcation line 

(underscore) 

fill output lines (on) 

equivalent to : .ef # t, .of # t 

controls footnote numbering : 

"t" reset each page, "f ' continuous, 

"u" suppress numbering 

delimits footnotes 

"go back" to label xxx 

"go forward" to label xxx 

equivalent to: .eh # t, .oh # t 

segment f.runoff inserted at point of 

request; value of "exp" assigned to 

"Parameter" 

indent left margin n spaces (0) 

define label xxx 

next n lines treated as text (1) 

line length is n (65) 

equivalent to : .ml +n, .m4 ±n (4) 

print only every nth page (1) 

multiple space of n lines (1) 

margin above headers set to n (4) 

margin between headers and footers 

set to n (2) 

margin between text and footers set 

to n (2) 

margin below footers set to n (4) 

do not right justify (off) 

need n lines; begin new page if not 

enough remain (1) 

do not till output lines; print them 

exactly as entered (off) 

defines odd footer line # 

defines odd header line # 

next page number is odd 
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.pa ±n 


.pin 


.pi ±n 


.rd 


.ro 


.rt 


.sk n 


.sp n 


.sr sym exp 


ss 


.tr cd 



begin page n 

skip n lines if n remain; otherwise 

skip n on next page before any text 

(1) 

page length is n (66) 
read one line of text from the 
user_input I/O switch and process it 
in place of .rd line 

roman numeral page numbers (arabic) 
"return" from this input segment 
skip n lines (1) 
space n lines (1) 

assign value of "exp" to variable 
named "sym" 
single space (on) 

translate nonbiank character c into d 
on output 

process next input line only if n is not 
zero (1) 

write "xxx" onto error._output I/O 
switch 

indent next text line n spaces less 
(left margin) 

substitute values of variables in 
"text", and scan line again 
read one line of text from user_input 
I/O switch and discard it 
.* comment line; ignored 

~ comment line; ignored, but included in 

chars output segment 
BUILT-IN SYMBOLS 

runoff has over 50 internal variables, which are avail- 
able to the user. In addition, the user can set his own 
variables with the .sr control request. See the runoff 
command in the MPM Commands for the list of 
built-in symbols. 

EXPRESSIONS 

Expressions can be either arithmetic or string and 
consist of numbers and operators in appropriate com- 
binations. The operators and order of precedence are: 

(bit-wise negation), -(unary) 
*,/,\ (remainder) 

+ ,- (binary) 

=j < 5 >, =£, (all are comparison operators that 



.ts n 



.ty xxx 



.un n 



.ur text 



.wt 
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& 



yield -1 for true or for false) 

(bit-wise AND) 

(bit-wise OR), = (bit-wise 

equivalence) 



runoff_abs, rfa 

submits an absentee request to process text segments 
using the runoff command. 

Usage: rfa paths {— rf_args} {-ear_args} {-dp_args} 
{-abs_control_args } 

rf_args 

control arguments accepted by the runoff 
command. 

ear_args 

control arguments accepted by the 

enter _abs_ request command (except -brief). 

dp_args 

control arguments (except -brief and 
-truncate) accepted by the dprint command. 

abs_control_args 
-copy N, -cp N 
-hold 
-queue N, -q N 

safety _sw_off, ssf 

turns off the safety switch of a segment, directory, or 
multisegment file, thus permitting the segment, direc- 
tory, or multisegment file to be deleted. 

Usage: safety _sw_ off {paths} 

safety _sw_on, ssn 

turns on the safety switch of a segment, directory, or 
multisegment file, thus preventing deletion of that seg- 
ment, directory, or multisegment file. 

Usage: safety_sw_on {paths} 

send_message, sm 

sends messages (one or more, always sent one line at a 
time) to a given user on a given project. 

Usage: send_message Person_id Project_id {message} 
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message 

a string up to 132 characters long. If omitted, 
send_message types "Input :" and accepts 
lines that it sends, one at a time, with each new- 
line character. In this case, input is terminated 
by a line consisting solely of a period. 



set_acl, sa 

manipulates the ACLs of segments, multisegment files, 
and directories. 

Usage: sa path model User_idl . . . moden { User_idn} 
{-control_args} 

-directory, -dr 
-segment, -sm 

set_bit_count, sbc 

sets a specified bit count on a specified entry. 

Usage: set_bit_count pathl countl . . . pathn countn 

counti 

is the bit count, in decimal, desired for pathi. 

set_ee 

sets the carriage control transformation for a specified 
FORTRAN formatted file either on or off. 

Usage: set_ccfileN {-control_arg } 

fileN 

name of the FORTRAN file in the range of 
fileOl to file99. 

control_arg 
-off 
-on 

set_com_line, scl 

changes the maximum size of expanded command 
lines. 

Usage: set_com_line {size} 



size 



is the new maximum expanded command line 
size. 
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set_iacl_dir, sid 

adds entries to a directory initial ACL in a specified 
directory or modifies the access mode in an existing 
directory initial ACL entry. 

Usage: sid path model User_idl . . . moden { User_idn} 
{-control_arg } 

-ringN,-rgN 

set_iacl_seg, sis 

adds entries to a segment initial ACL in a specified 
directory or modifies the access mode in an existing 
segment initial ACL entry. 

Usage: sis path model User_idl . . . moden { User_idn} 
{-control_arg } 

-ring N, -rg N 

set_search_rules, ssr 

allows the user to set his dynamic linking search rules 
to suit his individual needs with only minor restric- 
tions. Two types of search rules are permitted: abso- 
lute pathnames of directories to be searched and 
keywords. 

Usage: set_search_rules path 

set_tty,stty 

modifies the terminal type and modes associated with 
terminal I/O. 

Usage: set_tty {-control_args} 

-io_ switch XX, -is XX 

-modes XX 

can, ^can hndlquit, -Mindlquit 

capo, /s capo lfecho, Mfecho 

crecho, ^crecho UN 

default" plN 

echoplex, rawi, ^rawi 

'^echoplex rawo, ^rawo 

edited, ^edited red, ^red 

erkl, ^rkl tabecho, -Mabecho 

esc, ^esc tabs, ^tabs 

fulldpx, vertsp, ^vertsp 

-^fulldpx 



53 



-print 

—reset 

-tabs 

-terminal_type XX, -ttp XX 

1050 TN300,tn300 

2741 TTY33, tty33 

ARDS,ards TTY37,tty37 

ASCII, ascii TTY38, tty38 

CORR2741,corr2741 

sort_seg, ss 

orders the contents of a segment according to the 
ASCII collating sequence. 

Usage: sort_segpath {-control_args} 

-all, -a 

-ascending, -asc 

-block N, -bk N 

-delimiter XX, -dm XX 

-descending, -dsc 

-field SI LI S2 L2 . . . Sn Ln, 

-fl S 1 LI S2 L2 . . . Sn Ln 
-replace, -rp 
-segment path, -sm path 
-unique, -uq 

start, sr 

resumes execution of the user's process from the point 
of interruption after a signal has suspended execution. 

Usage: start {-control__arg} 

-no_restore, -nr 

status, st 

prints status information about storage system entries. 

Usage: status paths {-control_args} 

Segments, Multisegment Files, and Directories: 
-all, -a 
-author, -at 
-date, -dt 
—device, — dv 
-length, -ln 
—mode, — md 
-name, -nm 
-type, -tp 
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Links: 

-all, -a 
-author, -at 
-date, -dt 
-name, -nm 
-type, -tp 

stop_coboI_run, scr 

causes the termination of the current COBOL run 
unit. 

Usage: stop_cobol_run {-control_arg} 

-retain_data, -retd 

terminate, tm 
terminate_segno, tms 
terminate_refname, tmr 
terminate_single_refname, tmsr 

terminates reference names for a segment, unsnaps links 
to the segment, and makes the segment unknown if it 
has no reference names left. 

Usage: terminate paths 

Usage: tms segnos 

Usage: tmr ref_names 

Usage: tmsr ref_names 

seg_nos 

segment numbers (in octal). 

re f_ names 

reference names. 



trace 

a debugging tool that monitors all calls to a specified 
set of external procedures. 

Usage: trace {-control_args} names 

control_args 
-after N 
-argument N, 

-agN 
-before N 



-brief, -bf 
-depth N, -dh N 
-every N, -ev N 
-execute XX, 



-meter off, -mt off 

-meter on, -mt on 

-off entryname 

-on entryname 

-out 

-remove entryname, 

-rm entryname 
-reset entryname, 
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-ex XX 

-first N, -ft N 
-govern off, 

-gv off 
-govern on, 

— gv on 
-in 
-inOut 
-io_ switch XX, 

-is XX 
-last N, -It N 
-long, -lg 



-rs entryname 
-return_value off, 

-rv off 
-return_value on, -rv on 
-status *, -st * 
-status entryname, 

-st entryname 
-stop_proc path, -sp path 
-subtotal, -stt 
-template, -tp 
-total, -tt 
-watch XX, -wh XX 



names 

is a pathname or reference name used in the 

trace table. 

trace_stack, ts 

prints machine conditions and stack history of the 
process, most recent first. 
Usage: trace_stack {-control_args} 

-brief, -bf 
-depth N, -dh N 
-long, -lg 

truncate, tc 

truncates a segment to a specified length and resets the 
bit count accordingly. 
Usage: truncate {-control_arg } seg_no length 

seg_no 

a pathname or an octal segment number. 

length 

an octal integer indicating the length of the 
segment in words after truncation. 

control_arg 
-name, -nm 

unassign_resource, ur 

unassigns a resource that has been assigned to the 
caller's process. 
Usage: unassign_resource resource {-control_args} 
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resource 

specifies the name of the resource to be 
unassigned. 

control_args 

-comment XX, —com XX 
-admin, -am 

unlink, ul 

deletes the specified link entry. 

Usage: unlink paths 

vfile_adjust, vfa 

adjusts a storage system file left in an inconsistent 
state by an interrupted opening. 

Usage: vfile_adjust path {-control_arg} 

-set_bc 
-set_nl 
-use_bc {n} 
-use_nl 

vfile_status, vfs 

prints the apparent type (unstructured, sequential, 
blocked, or indexed) and length of storage system 
files. 

Usage: vfile_status path 

walk_subtree, ws 

executes a command line in a given directory (called 
the starting node) and in directories inferior to the 
starting node. 

Usage: walk _ subtree path command_line {-control_args} 

command _line 

command line to be executed (multiple-word 
command line should be typed as a quoted 
string). 

control_args 

-bottom_up, -bu 
-brief, -bf 
-first N, -ft N 
-last N, -It N 
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where, wh 

searches for a given reference name using the standard 
search rules and initiates the segment if found. 

Usage: where ref_names 

who 

lists User_ids and other information about current 
users of the system. 

Usage: who {args} {-control_args } 

args 

Person_id 

.Project_id 

Person_id.Project_id * 

control _ args 
-absentee, —as 
-brief, -bf 
-long, -Ig 
-name, -nm- 
-project, -pj 
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tells system user has terminal similar to EBCDIC IBM 
Model 2741 that must be recognized before he can log 
in. 



Usage: 963 



029 



tells system user has terminal similar to Correspond- 
ence code IBM Model 2741 that must be recognized 
before he can log in. 



Usage: 029 



ACTIVE FUNCTIONS 

The format of each active function in this document is 
based on those found in the MPM Commands. The active 
function name is shown in boldface type followed by a brief 
description of the value this active function returns. In the 
usage line, after the name and description, the following con- 
ventions apply: 

1. For simplicity, four common types of arguments ac- 
cepted by active functions have been abbreviated as 
follows: 

str any character string. 

t f character string that has the value "true" or 

"false", 
de c character string that represents a decimal 

number, 
dt character string that represents a date and 

time (see also item 5 below). 

2. If an active function accepts more than one of a 
specific argument, "_args" is added to the argument 
name (e.g., tf_args). 

3. Arguments that must be given in pairs are indicated 
with an "A" and "B" (e.g., strA strB). 

4. Optional arguments are enclosed in braces (e.g., 
{ strB}). All other arguments are required. 

5. Each dt argument must be in a form acceptable to the 
convert_date_to_binary_ subroutine described in 
the Multics Programmers' Manual Subroutines, Order 
No. AG93. If an optional dt argument is not given, 
information about the current date and time is 
returned. 

6. The term star_name means any pathname that con- 
forms to the star convention. 

The active functions listed below are grouped according 
to operation. An abbreviated description for each active 
function is given in the following pages, arranged in alpha- 
betical rather than operational order. 
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Arithmetic 


equal 


ceil 


exists 


divide 


greater 


floor 


less 


max 


nequal 


min 


ngreater 


minus 


nless 


mod 


not 


plus 


or 


quotient 




times 


Segment Name 


trunc 


directories, dirs 




directory 


Character String 


entry 


format_line 


files 


index 


get_ pathname, gpn 


index_set 


home_dir 


length 


links 


search 


nondirectories, nondirs 


string 


nonlinks, branches 


substr 


nonsegments, nonsegs 


verify 


path 




pd 


Date and Time 


segments, segs 


date 


strip 


date _ time 


strip_entry, spe 


day 


suffix 


day _ name 


unique 


hour 


wd 


long_date 




minute 


User Parameter 


month 


have_mail 


month_name 


system 


time 


user 


year 






Question Asking 


Logical 


query 


and 


response 
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and 

true if all the tf_args = true; otherwise false. 

Usage: [ and tf_args J 

ceil 

smallest integer > dec. 

Usage: [ ceil dec ] 

date 

date abbreviation in the form "mm/dd/yy". 

Usage: [ date { dt } ] 

date_time 

date abbreviation, a time from 0000.0 to 2359.9, a 
time zone abbreviation, and a day of the week 
abbreviation. 

Usage: [ date_time {dt} ] 



day 

one- or two-digit number of a day of the month, from 
1 to 31. 
Usage: [day {dt} ] 

day_name 

name of a day of the week. 

Usage: [ day_name {dt} ] 

directories, dirs 

names (separated by blanks) of all directories matching 
star_name. 
Usage: [ directories star_name ] 

directory 

directory portion of the absolute pathname of path. 

Usage: [ directory path ] 

divide 

integer part of the value of dec A / decB. 

Usage: [ divide decA decB ) 
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entry 

entryname portion of the absolute pathname of path. 

Usage: [ entry path J 

equal 

true if strA = strB; otherwise false. 

Usage: [ equal strA strB ] 

exists 

checks for the existence of various types of items 
depending on the value of key. 

Usage: [ exists key str ] 

key 

argument 

true if it has been passed an argument str; 
otherwise false. 

branch 

true if a branch with pathname str exists; 
otherwise false. 

directory 

true if a directory with pathname str exists; 
otherwise false. 

entry 

true if an entry with pathname str exists; 
otherwise false. 



file 



true if a segment or multisegment file str 
exists; otherwise false. 



link 



msf 



true if a link with pathname str exists; other- 
wise false. 

f 

true if a multisegment file with pathname 
str exists; otherwise false. 



non_null_link 

true if a link with pathname str exists and 
points to an existing segment, directory, or 
multisegment file; otherwise false. 

segment 

true if a nondirectory segment with pathname 
str exists; otherwise false. 
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files 

names (separated by blanks) of all segments, direc- 
tories, links, and multisegment files matching a given 
star_name. 

Usage: [ files star_name ] 

floor 

largest integer < dec. 

Usage: [ floor dec ] 

format_line, fl 

formatted character string that is constructed from a 
control string and other optional arguments. 

Usage: [ format_line control_string {args} ] 

control_ string 

is an ioa_ control string that is used to format 
the return value of the active function. 

args 

substituted in the formatted return value, 
according to the ioa_ control string. 

get_pathname, gpn 

absolute pathname of the segment that is designated 
by the reference name or segment number specified. 

Usage: [ get_pathname {-name } arg ] 

-name 

indicates that arg (which looks like an octal seg- 
ment number) is to be interpreted as a segment 
name. 



arg 

reference name or segment number. 

greater 

true if strA > strB; otherwise false. 

Usage: [ greater strA strB ] 

have_mail 

true if there is mail in the user's current default mail- 
box or in a specified mailbox; otherwise false. 

Usage: [ have_mail {path} ] 
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home_dir 

pathname of the user's home directory (usually of the 
form >user_dir__dir> Projected >Person_id). 

Usage: [ home_dir ] 

hour 

one- to two-digit number of an hour of the day, from 
to 23. 
Usage: [ hour { dt } ] 

index 

character position in strA where strB begins. If strB 
does not occur in strA, is returned. 

Usage: [ index strA strB ] 

index_set 

sequence of numbers from 1 through n (where n is a 
decimal integer), separated by spaces. 

Usage: [ index _ set n ] 

length 

character representation of the number of characters 
in str. 
Usage: [ length str ] 

less 

true if strA < strB; otherwise false. 

Usage: [ less strA strB ] 

links 

names (separated by blanks) of all links matching a 
given star_name. 

Usage: [ links star_name ] 

long_date 

month name, a day number, and a year in the form 
"month, day, year". 

Usage: [ long_date { dt } ] 

max 

numerical maximum of dec_args. 

Usage: [ max dec_args ) 
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min 

numerical minimum of dec_args. 

Usage: [ min dec__args ] 

minus 

result of decA - decB. 

Usage: [ minus decA decB ] 

minute 

one- or two-digit number of a minute of the hour, 
from to 59. 

Usage: [ minute { dt } ] 

mod 

decA modulo decB. 

Usage: [ mod decA decB | 

month 

one- or two-digit number of a month of the year, from 
1 to 12. 

Usage: [ month {dt} j 

month_name 

name of a month of the year. 

Usage: [ month_name {dt} j 

nequal 

true if decA = decB; otherwise false. 

Usage: [ nequal decA decB ] 

ngreater 

true if decA > decB; otherwise false. 

Usage: [ ngreater decA decB ] 



nless 

true if decA < decB; otherwise false. 

Usage: [ nless decA decB ] 
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nondirectories, nondirs 

names (separated by blanks) of all segments, links, 
and multisegment files matching a given star_name. 

Usage: [ nondirectories star_name ] 

nonlinks, branches 

names (separated by blanks) of all segments, direc- 
tories, and multisegment files matching a given 
star_name. 

Usage: [ nonlinks star_name ] 

nonsegments, nonsegs 

names (separated by blanks) of all directories, links, 
and multisegment files matching a given star__name. 

Usage: [ nonsegments star_name ] 



not 



false if str = true; true if str = false; otherwise an error 
diagnostic. 



Usage: [ not str J 

or 

true if any tf_arg = true; otherwise false. 

Usage: [ or tf._args j 

path 

absolute pathname of path_arg (which is a pathname). 

Usage: [ path path_arg ] 



Pd 



pathname of the process directory of the process in 
which it is invoked. 



Usage: [ pd ] 

plus 

sum of dec_args. 

Usage: [ plus dec_args ] 
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query 

true if the user's answer to the question was "yes"; 
false if the user's answer was "no"; otherwise an error 
diagnostic. If the question is more than one word (arg 
contains blanks), it must be enclosed in quotes. 
Usage: { query arg ] 

quotient 

result of decA / decB. 

Usage: quotient [ decA decB ] 

response 

answer typed by the user in response to the question 
specified by arg. If arg contains blanks, it must be en- 
closed in quotes. 

Usage: [ response arg ] 

arg 

the question to be asked. 

search 

first character position in strA that meets the follow- 
ing test: does any character in strB occur in strA? If 
no character of strB occurs in strA, is returned. 

Usage: [ search strA strB ] 

segments, segs 

names (separated by blanks) of all segments matching 
a given star_name. 

Usage: [ segments star_name ] 

string 

single character string. If no str_args are present, a null 
character string is returned. If one or more str_args are 
present, then any quotes in these are doubled when 
str_args are placed in the quoted return string. 

Usage: [ string {str_args} ] 

strip 

absolute pathname of the specified entry with the 
last component removed. If str is specified, the last 
component is removed only if it matches str. 

Usage: [ strip path {str} ] 
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strip _entry, spe 

entryname portion of the absolute pathname returned 
by the strip active function. If str is specified, the last 
component is removed only if it matches str. 

Usage: [ strip_entry path {str} ] 

substr 

portion of str starting with decA and continuing for 
decB characters (the default for decB is 1). 

Usage: [ substr str decA {decB} J 

suffix 

last component of the entryname portion of the speci- 
fied segment. If that entryname has only one com- 
ponent, it returns the null string. 

Usage: [ suffix path ] 

system 

various installation-dependent system parameters 

Usage: { system key ) 

key 

company 

per-system parameter company name. 

date_up 

date that the system was brought up, in the 
form "mm/dd/yy". 

department 

per-system parameter computer center de- 
partment name. 

down_until_date 

date that the system will next be brought up, 
if specified by operator, in the form 
"mm/dd/yy". 

down_until_time 

time that the system will next be brought up, 
if specified by operator, in the form 
"hhmm.t". 

ds_company 

per-system parameter company name, with 
the characters of the name double spaced. 
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ds_department 

per-system parameter computer center de- 
partment name, with the characters of the 
name double spaced. 

installation_id 

per-system parameter installation 
identification. 

last_down_date 

date that service was last interrupted, 
whether by shutdown or crash. 

last_down_ reason 

reason for the last system service interrup- 
tion, if known. The reason may be: 
shutdown normal system shutdown 
crash system crash (no number 

assigned) 
n number of system crash 

last_down_time 

time that service was last interrupted. 
max_units 

current maximum number of load units, in 

the form "nnn.n". 

max_users 

current maximum number of users. 

n_units 

current number of logged-in load units in- 
cluding daemon and absentee, in the form 
"nnn.n". 

nusers 

current number of logged-in users including 
daemon and absentee. 

next_down_date 

date that system will next be shut down, if 
specified by operator. 

next_down_time 

time that system will next be shut down, if 
specified by operator. 

next_ shift 

next shift number. 



69 



time 



reason_down 

reason for next shutdown, if specified by 
operator. 

shift 

current shift number. 

shift_change_date 

date on which current shift number will 
change to next_shift. 

shift_change_time 

time at which current shift number will 
change to next_shift. 

sysid 

version number of the hardcore system tape 
currently running. 

time_up 

time that system was brought up, in the 
form "hhmm.t". 



four-digit time of day in the form "hh:mm" where 
00 < hh < 23 and 00 < mm < 59. 



Usage: [ time {dt} ] 

times 

result of decA * decB. 
Usage: [ times decA decB ] 

trunc 

largest integer whose absolute value is < absolute value 
of dec. 

Usage: [ trunc dec ] 

unique 

unique character string as generated by the 
unique_chars_ subroutine. 



Usage: 



unique 
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user 

various user parameters. 

Usage: [ user key J 

key 

absentee 

true if the user is an absentee user; other- 
wise false. 

absin 

absolute pathname of absentee user's ab- 
sentee input segment including the absin 
suffix; otherwise a null string. 

absout 

absolute pathname of absentee user's ab- 
sentee output segment; otherwise a null 
string. 

anonymous 

true if the user is an anonymous user; 
otherwise false. 

auth 

short string for the authorization of the 
user's process or system_low. 

authlong 

long string (in quotes) for the authorization 
of the user's process or "system_low". 

briefbit 

true if the user specified the -brief control 
argument in his login line; otherwise false. 

cpu_secs 

user's CPU usage (in seconds) since login, in 
the form "sss.t" with leading zeros 
suppressed. 

log_time 

user connect time (in minutes) since login, 
the form "mmm.t". 

login_date 

date at login time, in the form 
"mm/dd/yy". 

login_time 

time of login, in the form "hhmm.t". 
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max_auth 

short string for the max authorization of the 
user's process or system_low. 

max_auth_long 

long string (in quotes) for the max authori- 
zation of the user's process or "system_low" 

name 

user's User_id at login time. 

outer__ modulo 

initial outer modulo for the terminal channel. 

preemption_time 

time at which the primary user becomes 
eligible for group preemption, in the form 
"hhmm.t". 

process_id 

user's process identification in octal. 

project 

user's Project_id. 

protected 

true is user currently a primary user and 
protected from preemption; otherwise false. 

secondary 

true if the user is currently subject to pre- 
emption; otherwise false. 

term_id 

user's terminal ID code. It is "none" it the 
user's terminal does not have the answer- 
back feature. 

term_type 

user's terminal type. It can have one of the 
following values: 

"Absentee" "CORR2741" "TN300" 
"Network" "TTY33" "ARDS" 

"1050" " TT Y37" "ASCII" 

"2741" "TTY38" 



verify 

first character position in strA that fails the following 
test: does any character in strB occur in strA? If every 
character of strB occurs in strA, is returned, 

Usage: [ verify strA strB ] 
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wd 

pathname of the working directory. 

Usage: [ wd ] 

year 

two-digit number of a year of the century. 

Usage: [ year {dt} ] 
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Unused Characters 

These characters are reserved for future use: 

SOH 001 ACK 006 DC4 024 

STX 002 DLE 020 NAK 025 

ETX 003 DC1 021 SYN 026 

HOT 004 DC2 022 ETB 027 

ENQ 005 DC3 023 CAN 030 



EM 031 

SUB 032 

ESC 033 

IS 034 

GS 035 

RS 036 

US 037 



73 




Honeywell Information Systems 

In the U.& A.: SSQO Smith Street. MS 486. WaJtham, Massachusetts 021S4 

In Canada: 2025 Sheppard Avenue East. WiHowdate. Ontario M2J 1 W5 

In Mexico: AvenkJa Nuevo Leon 250. Mexico 1 1 . D.F. 



15607, 5576, Printed in U.S.A. 



AW 17. R«v. O 



